home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / GSAVE2.ZIP / GSAVE2.DOC < prev    next >
Text File  |  1996-04-25  |  8KB  |  205 lines
  1. Graphics Save Version 2.0 (C)opyright 1995,1996 Earwax
  2.  
  3. Usage   : GSAVE2 <option>
  4.  
  5.         <option>
  6.                 : leave blank to install the TSR, ` (next to 1) will 
  7.                   activte the screen capture, or anything else you put in
  8.                   will be ignored unless it is "/u".
  9.  
  10.         /u      : will uninstall the TSR, freeing up about 1kb of RAM 8-).
  11.  
  12. Requirements:
  13.  
  14.         ∙■∙ a vga card capable of displaying 320x200x256
  15.         ∙■∙ a bit of HD space
  16.         ∙■∙ more than 1kb or RAM 8-)
  17.         ∙■∙ a assembler although not essential is recommended
  18.  
  19. Included Files:
  20.  
  21.         GSAVE2.COM
  22.                 The screen capture program.
  23.  
  24.         GSAVE2.DOC
  25.                 Dis file!
  26.  
  27.         GLOAD2.ASM/EXE
  28.                 Example of how to load SCREENGS.??? files in ASM.
  29.  
  30.         PASCAL.ZIP
  31.                 Example of using SCREENGS.??? files in TP.
  32.  
  33.         C_PLUS.ZIP
  34.                 Example of using SCREENGS.??? files in C.
  35.  
  36.         SCREENGS.000/PCX
  37.                 An ScreenGS file, by BenJ/Realm (hope you don't mind BenJ!)
  38.         and also an "PCX" file.
  39.  
  40.         GS2PCX.EXE
  41.                 This is an SCREENGS.??? to ????????.PCX, converter, the 
  42.         only problem that i have found with this is that just about no
  43.         viewers will actually load the PCX files properly. This may have 
  44.         something to do with the documentation which i didn't have, I had 
  45.         to remember the PCX Format from memory (except the header which i 
  46.         ripped)! But at least the images are compressed quite significantly 
  47.         in most cases. Some viewers, such as Pain(t) Shop Pro for Windows 
  48.         and Graphic Workshop, do load these PCX files properly, a lot of 
  49.         other (QPEG, Deluxe Paint etc.) don't!
  50.                 One good factor from all of this is that my "memory" PCX 
  51.         files seem to be smaller on average than PCX files generated by
  52.         other programs of the same images??? so hey, this is cool!
  53.  
  54.         PCXLOAD2.ASM/EXE
  55.                 Seeing you would never be able to load up the compressed
  56.         images, i decided to include a PCX? loader so you could use
  57.         encoded images, geez arent i nice!
  58.                 Note that this PCX loader will load normal PCX files as
  59.         well!
  60.  
  61.         BIN2HEX.EXE
  62.                 Program to convert Binary -> Hexidecimal. Very slow, but
  63.         i coded it about the same time i coded the 1st version on GSAVE,
  64.         so thats why it is sooo slow.
  65.                 Use this to include pictures etc, in with the final EXE
  66.         file.
  67.  
  68. Whats new?
  69.  
  70.         More stable TSR! (I hope 8-)) Doesn't crash Deluxe Paint, like
  71.  version 1.0 and never get any QEMM errors!        
  72.  
  73.         The last version on GSAVE (1.0) was very screwed, namely because
  74.  I had only been programming in assembler for a few weeks. I was going to
  75.  leave the program as it was and make no more updates, but i got bored and
  76.  decided to learn how to make a descent TSR. This TSR may not be perfect
  77.  but its a far cry from my first attempt. The older version was using 
  78.  INT16h, which as far as i can tell, seemed to be the cause of all the 
  79.  problems? This new version uses INT09h and INT21h, this seems to have
  80.  destroyed all the problems and I haven't encountered any of the problems
  81.  which were everywhere in the older version.
  82.  
  83.         This new version is also about 7-10 times faster than the original
  84.  version. The first version was VERY slow.
  85.  
  86.         The capture file is no longer is two seperate parts (PAL/PIC) but 
  87.  rather one file, which should be 64,768 bytes big.
  88.  
  89.         You can also capture up to 999 files in one "session", not just one
  90.  as in the previous version. The files are now called SCREENGS.???, where
  91.  ??? is the number of the image saved. Also note here that the more SCREENGS
  92.  files in one directory that you have the longer it will take to save, as 
  93.  the program has to scan for an non-existant file, I don't think i've 
  94.  explained that very well, but it doesn't really matter.
  95.  
  96.  
  97.         If you want to detect wether GSave is in memory, then it is a simple
  98.  process of putting "ax" equal to 3580h or 13696 decimal and calling INT21h
  99.  If gsave is installed "ax" will be equal to 0ffffh or 65535 decimal, if not 
  100.  then gsave is not installed. Heres a simple detection proggie ...
  101.  
  102.         mov     ax,3580h
  103.         int     21h
  104.         cmp     ax,0ffffh
  105.         jz      gsave_installed
  106.  
  107.         Why you would want to detect it however i have no idea?? but I told
  108.  ya anyway.
  109.  
  110. Format of the SCREENGS.??? file.
  111.  
  112.         This file is saved very simply and is very easy to load.
  113.  
  114.         The first 768 bytes contain the palette (RGB,RGB...), the next 
  115.  64,000 bytes contain the picture (320x200) in RAW format, an example 
  116.  program is included (GLOAD2.ASM/GLOAD2.EXE) and also a TPU file 
  117.  (PASCAL.ZIP) for implementation in TP programs, but why anyone would use 
  118.  TP, God only knows 8-). Also a C version (C_PLUS.ZIP) for all you C users.
  119.  
  120. Format of my "memory" PCX files.
  121.  
  122.         Header, 128 bytes
  123.  
  124.         Byte    Size            Should be
  125.         0       1               10         
  126.         1       1               5               (PCX Version)
  127.         2       1               1
  128.         3       1               8          
  129.         12      2               319             (MaxX-1)
  130.         14      2               199             (MaxY-1)
  131.         16      112             ?
  132.  
  133.         Picture, ??? Bytes
  134.  
  135.         Using run length compression, look at PCXLOAD2.ASM for an example
  136.  of how to decompress the images, quite simple really.
  137.  
  138.         Last 768 bytes
  139.  
  140.         This is the palette multiplied by 4, in RGB format. Don't ask me why
  141.  they are 4 times the size they are, thats just the way PCX works, I THINK!
  142.  
  143. Problems?
  144.  
  145. The Image is Screwed!
  146.  
  147.         Well its probably because the program you captured the image from
  148.  was using tweaked vga (commonly known as ModeX) and this is why the 
  149.  image looks like crap. Sorry but i can't be fucked writting a ModeX screen
  150.  capture program, cause people often do that so you can't rip art, so 
  151.  guess what. I aint helping!
  152.  
  153.  
  154. My program uses ` , but it grabs the screen instead!
  155.  
  156.         Tough Shit, no solution 8-)
  157.  
  158.  
  159. In some Programs I can't Capture Screens!
  160.  
  161.         This may be because
  162.  
  163.             ∙■∙ Your trying to capture a screen which isn't in
  164.                 320x200x256 colors, or
  165.  
  166.             ∙■∙ The programmers have deliberately made it so that
  167.                 all previous INT09h instructions have been temporarily
  168.                 trashed, note that many demos do this.
  169.  
  170. Contacting the Legend(?)
  171.  
  172.         You wanna mail me? if you do then you can either ring the following
  173.  BBS(s) which i frequently use 
  174.  
  175.         Morbid Reality (West Aust)
  176.          Node 1 : +619 385 0740
  177.          Node 2 : +619 385 5337
  178.  
  179.         Or Snail mail me at
  180.  
  181.         Earwax (Aaron Hughes)
  182.         20, Southgate court Kingsley
  183.         Perth, Western Australia
  184.         6026
  185.  
  186.         Or Email me at
  187.  
  188.         hughesal@cs.curtin.edu.au
  189.         EHUGHESALH@alpha1.curtin.edu.au
  190.  
  191.         before March 1997
  192.  
  193.  ∙ Earwax/Realm ∙ 12th January 1996
  194.  
  195. Late Update!
  196.  
  197.         This program has been finished for many months now except for the
  198.  unload function, which will de-activate the TSR but leave it in memory,
  199.  as i cant find any information on unloading TSR's from memory i have
  200.  decided to leave this option unfinished, which will mean that you can
  201.  load GSAVE2 into memory multiple times, which is a bit of a piss off for me
  202.  because i wanted this little TSR to be finished
  203.  
  204.  ∙ Earwax/Realm ∙ 25th August 1996 
  205.